home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / comm / bbs / Defuser3.readme < prev    next >
Encoding:
Text File  |  1995-02-13  |  6.0 KB  |  152 lines
  1. Short:    Mail bomb protection for BBSes (Arexx)
  2. Author:   mat@darkside.demon.co.uk (Mat Bettinson)
  3. Uploader: mat@darkside.demon.co.uk (Mat Bettinson)
  4. Type:     comm/bbs
  5.  
  6.              _____        __                       ____   ___  
  7.             |  __ \      / _|                     |___ \ / _ \ 
  8.             | |  | | ___| |_ _   _ ___  ___ _ __    __) | | | |
  9.             | |  | |/ _ \  _| | | / __|/ _ \ '__|  |__ <| | | |
  10.             | |__| |  __/ | | |_| \__ \  __/ |     ___) | |_| |
  11.             |_____/ \___|_|  \__,_|___/\___|_|    |____(_)___/ 
  12.                                                    
  13.      Mail Bomb and Resume Damage protection and repair by Mat Bettinson
  14.                       of the London Xenolink Alliance.
  15.  
  16. New for 3.0:
  17.  
  18. 3.0 operates basically the same way but has PROPER LHA RESUME damage
  19. checking that WORKS. Really! You can also turn it off. have a peek at the
  20. start of the script as you may have to change some bits.
  21.  
  22. I killed the VERBOSE feature below leaving a standard medium level of
  23. logging throughout. The rest of the arguments will be parsed to LHA instead. 
  24.  
  25. IE Rx Defuser %s -b100 
  26.  
  27. Will parse -b100 to LHA etc... 
  28.  
  29. LHA checking is relatively time consuming and may take as long as the
  30. unpacking! Well not THAT bad but it isn't nippy. It'll have to stay that way
  31. until coded in something quicker OR just turn it off by removing the TP =
  32. 'YES' line in the header of the script. 
  33.  
  34. <-----------------------------------CUT----------------------------------->
  35.  
  36. ** New additions to 2.5 indicated by **
  37.  
  38. Bugger it. I can't find the original docs (did I do some?) so I've knocked
  39. up a quick doc and instead of encoding it I'll post as a message.
  40.  
  41. <-----------------------------------CUT----------------------------------->
  42.  
  43. Excuse the quick docs. I'm sure you'll appreciate the urgency. 
  44.  
  45. Defuser 2.0 is basically the same as the earlier version but since it's been
  46. pulling in my mail for the BBS for weeks it seems to be stable and it
  47. catches Mail-Bombs and Trapdoor Abortions when I throw them at it. 
  48.  
  49. How to use: (it's easy)
  50.  
  51. Copy Defuser.rexx to rexx: on your system.
  52.  
  53. Couple of software examples:
  54.  
  55. Spot: Sytem menu. C:LHA x will be there. Actually this simple command will
  56.       be in most software. Simple replace with 'rx Defuser'
  57.  
  58. Most BBS software is the same. Noteable exception is Xenolink:
  59.  
  60. LZH:.LZH ?? ?? 2D 6C 68
  61.    EXTRACT = rx defuser %s
  62.    ARCHIVE = C:LHA -0 -m -N -q a
  63.  
  64. LHA:.LHA ?? ?? 2D 6C 68
  65.    EXTRACT = rx defuser %s
  66.    ARCHIVE = C:LHA -2 -m -N -q a
  67.  
  68. In Xconfig:Archivers.config
  69.  
  70. Likewise in any other software just replaces the LHA x with 'rx Defuser'
  71.  
  72. There's also a bit that you can edit in the Arexx program itself:
  73.  
  74. */
  75. EXEdir = 'C:'
  76. MaxSize = 75000
  77. MaxArc = 3000000
  78. Logfile = 'MAIL:Defuser.log'
  79. BadPKT = 'XIN:BAD/'
  80. LHAOpt = 'x -q'
  81. BBSTemp = ''
  82. CheckResume = 'YES'
  83.  
  84. /*
  85.  
  86. ** New for 2.5: There is now a BBStemp line here. If your BBS software uses
  87. ** temp files you can place the name there. If nulled (as default) ALL files
  88. ** assumed to be mail packets. This will cause no harm but will fill your
  89. ** inbound with crap files where defuser guessed wrong.
  90.  
  91. ## New for 3.0 the CheckResume line. Enables or disables this function.
  92. ## With it OFF you'll not notice Defuser at all and be given mail bomb
  93. ## protection. With it ON the time can be noticable on large packets but
  94. ## you WILL NOT lose mail from Resume-Append damaged packets.
  95.  
  96. EXEdir is the place where your LHA, Copy, Delete etc live. 
  97. MaxSize is the maximum size of the INDIVIDUAL packets in your mail packet.
  98.         this may need to be raised to a very high value if your Boss sends
  99.         packets over 64K. 
  100. MaxArc is the largest size of the extracted mail archive. Just make a large 
  101.        value but well under the space free on your inbound.
  102. Logfile is the full path and filename of the Defuser log where it will 
  103.         report all actions to since a console is hardly ever available.
  104. BadPKT is the dir to sling suspect packets that file for closer inspection
  105.        and/or deletion by yourself. Needs ':' or '/' at the end.
  106. LHAOpt is the LHA options you would normally use to extract. The q switch
  107.        in this case makes it quiet and the x switch is your extract command.
  108.  
  109. Right... The actual TRAP PRONG section of the code doesn't need any
  110. configuring... Defuser will log it's actions to the log file and it will
  111. strip the appended file/files off and save as the same packet name only with
  112. a bumped extention IE TH0 becomes TH1 etc... It WILL check to see if it
  113. exists before doing so in which case it will pick a higher extention and so
  114. on. :-) No pissy coding here! :-) 
  115.  
  116. OK so it will extract the FIRST file obviously but it WILL NOT extract the
  117. remaining files. This is so it's logged in your BBS software and lazyness
  118. (!) and security and it works! :-) You just have to perform another import
  119. to catch the file again. If it STILL isn't a single file Defuser will again
  120. strip the remainer off save it out and extract the first bit and so on... 
  121.  
  122. All actions will be logged in the log file as usual.
  123.  
  124. OK that's it. 
  125.  
  126. Fiver in the post for saving your mail eh? :-) 
  127.  
  128. BTW I've tried to E-Mail those Bugger Trapdoor Authors but their host has
  129. mysteriously vanished according to Demon. :-/ I'll send a Net-Mail and if
  130. anyone wants to post Defuser in a News group etc then go right ahead. I'm
  131. not going to as those Internet types hardly ever bother with Fido. :-|
  132.  
  133. Stay safe and may the mail flow.
  134.  
  135. Mat Bettinson:  Fidonet 2:254/205  Amiganet 39:139/5 
  136.                 E-Mail mat@darkside.demon.co.uk
  137.      _ ___
  138. /\/\(-) |  Sysop of Creations, plot hatcher and general Aussie Nuisance.  
  139.  
  140. ... This Tagline is a figment of your intelligence
  141.  
  142.  
  143. ============================= Archive contents =============================
  144.  
  145. Original  Packed Ratio    Date     Time    Name
  146. -------- ------- ----- --------- --------  -------------
  147.     5497    2625 52.2% 29-Nov-94 16:15:52  Defuser.doc
  148.     4918    2257 54.1% 01-Dec-94 19:28:32  Defuser.rexx
  149.      465     199 57.2% 13-Nov-94 23:42:24  Creations.displayme
  150. -------- ------- ----- --------- --------
  151.    10880    5081 53.2% 23-Dec-94 04:55:56   3 files
  152.